home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / bmenu54.arc / BMENU54.DOC < prev    next >
Text File  |  1990-02-12  |  9KB  |  262 lines
  1.  
  2.  
  3.                      ┌─────────────────────────────────────┐
  4.                      │    ░▒▓█  Batch Menu System █▓▒░     │
  5.                      │                                     │
  6.                      │            Pop up menus             │
  7.                      │          right in your own          │
  8.                      │            batch files!             │
  9.                      │                                     │
  10.                      │  BMENU 5.4                 2/12/89  │
  11.                      │  (C) 1990 by Mark Strong            │
  12.                      └─────────────────────────────────────┘
  13.  
  14.  
  15.     The  Batch Menu System allows you to insert pop-up menus within a  batch
  16.     file.
  17.  
  18.     Similar to the Norton Utilities ASK function,   BMENU returns the error-
  19.     level of  the item selected.   BMENU allows the choice of menu location,
  20.     title, item list and optionally, color.
  21.  
  22.     For example, the command (using default black and white colors):
  23.  
  24.          bmenu 10 5 Title Choice1 Choice2 Choice3
  25.  
  26.     would produce a menu at row 10,  column 5,  with title "Title" and three
  27.     choices.  If  the user selects choice 1,  the errorlevel return is  1,
  28.     choice 2 returns errorlevel 2, and so on.  If ESC or ^C (Ctrl-Brk) is
  29.     pressed, errorlevel 0 is returned to trap a "no choice made" condition.
  30.  
  31.     You can also use quotes to use multi-word choices:
  32.  
  33.          bmenu 10 5 "My Menu" Choice1 Choice2 "Another Choice"
  34.  
  35.      or use an @file:
  36.  
  37.          bmenu @filename.ext
  38.  
  39.     The @file must have the format of one command line argument per line.
  40.     For the last example, filename.ext would contain:
  41.  
  42.         10
  43.         5
  44.         My Menu
  45.         Choice1
  46.         Choice2
  47.         Another Choice
  48.  
  49.  
  50.     Several example batch files are included to demonstrate various uses
  51.     of Bmenu, including @files and color definitions.
  52.     MULTIPLE MENUS:
  53.  
  54.     @file listings may now have multiple menus within a single file.  Simply
  55.     delimit the menus with the dollar sign ($) and then a label ($mymenu).
  56.     Then call bmenu as follows:
  57.  
  58.     bmenu @file mymenu
  59.  
  60.     Bmenu will search the @file until the label is found and read the commands
  61.     until the end of file, or the next $ menu is found.  If you need to use 
  62.     the dollar sign in a menu choice, use quotes around the entire choice, and
  63.     Bmenu will consider the line an argument rather than a multiple menu 
  64.     label.
  65.  
  66.     Comments are also allowed.  Any line beginning with a colon (;) is ignored
  67.     by bmenu.  
  68.  
  69.     Example contents of menus.fil:
  70.  
  71.         ;
  72.         ; Example menu file for BMENU 5.4
  73.         ;
  74.         2
  75.         50
  76.          Title 
  77.         Choice 1
  78.         Choice 2
  79.         Choice 3
  80.         ;
  81.         ; If the user wishes to have $'s in the menu choices, 
  82.         ; enclose the choice with quotes (but remember, quotes are not a space)
  83.         ;
  84.         $menu2
  85.         2
  86.         50
  87.          Dollar Sign Example 
  88.               Choice 1 
  89.               Choice 2
  90.         "      $Choice 3    "
  91.         ; Above spacing is necessary to line up C C and $ 
  92.         ;    because the quote is not a space
  93.         "$Choice 4"
  94.         ; If $ is first on line, OK also
  95.  
  96.     Note that no $ label is used for the first menu, as this is the default
  97.     input when an @file is used.  If you want to label the first menu, you
  98.     must always reference that label in order to use the menu.  The above 
  99.     menus.fil file could be used two ways:
  100.  
  101.         bmenu @menus.fil
  102.     or
  103.         bmenu @menus.fil menu2
  104.  
  105.     Each of which would access the appropriate menu.
  106.     COLOR:
  107.     
  108.         User defined colors are now available on the command line.  Simply 
  109.     follow the row and column numbers with a dash then the window, menu, 
  110.     and selection bar color numbers, in decimal.  For example,
  111.  
  112.             bmenu 10 10 -3 5 65 title choice1 choice2
  113.  
  114.     would produce a cyan border with magenta menu choices and a red bar with
  115.     a blue word for the current menu choice.  The colors may also be included
  116.     in an @file, with the above example being:
  117.  
  118.            10
  119.            10
  120.            -3
  121.            5
  122.            65
  123.            title
  124.            choice1
  125.            choice2
  126.  
  127.  
  128.     The color combinations are made by adding the decimal values of the 
  129.     foreground and background colors.
  130.  
  131.                  ┌───────────────────────────────────┐
  132.                  │ ░▒▓█     Color Attributes    █▓▒░ │
  133.                  └───────────────────────────────────┘
  134.  
  135.     Foreground Colors:
  136.  
  137.     Black        0            Gray            8
  138.     Blue        1            Light Blue        9
  139.     Green        2            Light Green        10
  140.     Cyan        3            Light Cyan        11
  141.     Red        4            Light Red        12
  142.     Magenta            5                       Light Magenta            13
  143.     Brown        6            Yellow                14
  144.     Light Gray    7            White            15
  145.  
  146.  
  147.     Background Colors:
  148.     
  149.     Black        0
  150.     Blue        16
  151.     Green        32
  152.     Cyan        48
  153.     Red        64
  154.     Magenta            80
  155.     Brown        96
  156.     White        112
  157.  
  158.  
  159.     NOTES:
  160.  
  161.     Typing `bmenu' alone lists the usage of the program.
  162.  
  163.     Feel free to comment or make suggestions, but if you find the program 
  164.     useful, please register.  I appreciate the distribution via BBS's and
  165.     permission is granted to make copies of BMENU for this purpose.  Feel
  166.     free to distribute the program to friends and others who can make use
  167.     of a batch menu system.
  168.  
  169.     With the addition of multiple menu @files, Bmenu has become VERY network
  170.     compatible.  Try it instead of numerous ECHO statements for menus.
  171.  
  172.     Portions of this program Copyright 1986,1987 New Dimension Software.
  173.  
  174.     Address correspondence to:    Mark Strong
  175.                                   6029 Eastridge Lane
  176.                                   Cincinnati, OH  45247
  177.  
  178.     or CompuServe mail [70043,114]
  179.     ________________________________________________________________________
  180.  
  181.  
  182.     Update History:
  183.  
  184.     1.0    -  original offering, 3/22/89 or so?
  185.  
  186.     2.0 -  added color, if you want it, thanks to H. C. Wottle, 5/89 
  187.  
  188.     3.0 -  changed errorlevel return value so that ESC returns 0,
  189.            and choice 1 = errorlevel 1, etc.
  190.            Thanks to W. F. Hines, 11/15/89
  191.  
  192.     4.0    -  added @file capability, fixed choice handling for consistent
  193.            spacing, and cursor size,  12/04/89
  194.  
  195.     5.0    -  added optional color definition on the command line, 1/14/90
  196.     5.2    -  fixed bug in command line @file definition, spotted by T.Scott
  197.            1/29/90
  198.     5.3 -  added optional multi-menu @files, again thanks to T.Scott, 1/31/90
  199.     5.4 -  Corrected handling of ^C and Ctrl-Brk, 2/12/90
  200.  
  201.     I hope anyone reading this replaces the BMENU, BMENU2-A, BMENU2-B,
  202.     BMENU3, BMENU4, and BMENU5 files floating around with this file,
  203.     BMENU54.ZIP dated 02/12/90.
  204.  
  205.                                  Bmenu 5.4
  206.                              Registration Form
  207.  
  208.                      (C) Copyright 1990 by Mark Strong
  209.  
  210.  
  211. Name            ________________________________
  212.  
  213. Company         ________________________________
  214.  
  215. Address         ________________________________
  216.  
  217. City, State     ________________________________
  218.  
  219. Zip             ________________________________
  220.  
  221.  
  222.  
  223. Where did you obtain this copy of Bmenu 5.4? ________________________________
  224.  
  225. ____________________________________________________________________________
  226.  
  227.  
  228. Were you a user of previous Bmenu programs, and if so which version?
  229.  
  230. ___________________________________________________________________________
  231.  
  232.  
  233. Comments/Suggestions: ______________________________________________________
  234.  
  235. ____________________________________________________________________________
  236.  
  237.  
  238. The cost to register one copy of Bmenu is $10.00.  Registration entitles
  239. you to legally continue to use the program, plus written notification of 
  240. future versions.  For a contribution of $15.00 or more, you receive the above
  241. benefits plus the latest version of Bmenu or the next release, whichever is 
  242. applicable, via postage paid first class mail.  (Site licenses are also 
  243. available, write for info and include expected usage.)  Please make checks 
  244. payable to Mark Strong, and send to the address listed below. 
  245. Thank you for your interest, and for supporting Shareware products.
  246.  
  247.  
  248. Please check:  Registration ($10) ____   Registration + disk ($15) ______
  249.  
  250.                Site License Info  ____   Expected use:  _________________
  251.  
  252.     
  253.          Circle Disk Size (if $15.00 or more) :    5.25       3.5
  254.  
  255.              Additional disks:                     ____ x $5 = ___________
  256.  
  257.                                                Total Enclosed: ___________
  258.  
  259. Please remit to:            Mark Strong
  260.                             6029 Eastridge Lane
  261.                             Cincinnati, OH  45247
  262.